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1 Introduction 


This application note describes a LIN demo that was designed for the 
SAE show in March 2000. The project was intended to demonstrate the 
LIN protocol, tools and Freescale products that were available. Although 
the demo is purely visual and does not represent any particular 
application, it does introduce many features that would be implemented 
in actual applications, such as CAN-LIN gateway, sleep mode, 
messaging scheme, LIN drivers and LIN tools. The hardware was 
designed to be flexible and can easily be configured to drive many real 
applications. 

An introduction to the LIN protocol and general description of the demo 
is presented first, followed by a detailed description of the hardware and 
software, including schematics and flow diagrams. All code listings are 
included in the Appendix. 

2 Local Interconnect Network Bus (LIN) 


The LIN bus is an inexpensive serial communications protocol, which 
effectively supports remote application within a car’s network. It is 
particularly intended for mechatronic nodes in distributed automotive 
applications, but is equally suited to industrial applications. It is intended 
to complement the existing CAN network leading to hierarchical 
networks within cars. The protocol’s main features are listed below: 

• Single master, multiple slave (i.e. no bus arbitration) 
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• Single wire communications up to 20Kbit/s 

• Guaranteed latency times 

• Variable length of data frame (2, 4 and 8 byte) 

• Configuration flexibility 

• Multi-cast reception with time synchronization, without crystals or 
ceramic resonators. 

• Data checksum and error detection 

• Detection of defect nodes 

• Low cost silicon implementation based on standard UART/SCI 
hardware 

• Enabler for hierarchical networks 

Data is transferred across the bus in fixed form messages of selectable 
lengths. The master task transmits a header that consists of a break 
signal followed by synchronization and identifier fields. The slaves 
respond with a data frame that consists of between 2,4 and 8 data bytes 
plus 3 bytes of control information. Figure 1 shows the communication 
concept of message transfer and the message format. 
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Figure 1 LIN Message frame 
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Local Interconnect Network Bus (LIN) 
Header Frame 

The master controls all bus traffic on the network. The master initiates 
communication by transmitting a header frame with synchronization and 
identifier information. Any slave, including the slave task in the master 
control unit, can respond with a data frame. Only one slave can respond 
to each identifier. However, any number of slaves can be configured to 
recognize a particular identifier driven on the bus. The master control 
unit can transfer data to any number of slaves through its slave task. i.e. 
the master’s slave task responds to a header (sent by the master) and 
transmits data on to the bus. All other slaves can simultaneously receive 
the data frame. 

2.1 Header The header frame consists of 3 main parts: a SYNCH BREAK signal, a 

Frame SYNCH FIELD and an IDENTIFIER. The SYNCH BREAK is used to 

identify the beginning of a message frame and allow the slaves to 
synchronise to the master’s bus clock. It is a unique signal that has 2 
parts: a Dominant SYNCH BREAK that is longer than any regular 
dominant bit stream, and a synchronisation delimiter that is required to 
enable the detection of the start bit of the following SYNCH FIELD. 
Figure 2 shows the SYNCH BREAK field. 
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Figure 2 SYNCH BREAK field 

The timing specification for the SYNCH_BREAK field is dependent on 
the tolerance of the slave node’s clock source. The master is always 
required to transmit a dominant TsvNBRKSignal, that is a minimum 13 bits, 
measured in the master’s time base. The slave detects a break signal if 
it is dominant for longer than any regular bit stream. If the slave’s clock 
source has a tolerance lower than +- 15% (Fjol unsynch) the SYNCH 
BREAK THRESHOLD is 11 bit times (number of dominant bits required 
to be recognised as a SYNCH BREAK FIELD) measured in the slave’s 
time base. If the clock source’s tolerance is less than +- 2% (Fjol synch 
) the threshold is reduced to 9 dominant bits. 

The second part of the header is the SYNCH FIELD that contains the 
pattern 0x55 to allow the slave to synchronize with the master. This 
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allows low cost microcontrollers with internal RC oscillators to be used 
in slave nodes. 

NOTE: Internal oscillators have a low tolerance that requires to be trimmed 
(actively changed) if reliable communication is to be maintained. 

The final part of the header is the IDENTIFIER FIELD that denotes the 
content and length of a message. The content is represented by 6 
identifier bits and 2 parity bits. Identifier bits ID4 and IDS specify the 
number of data fields in a message. Figure 3 shows the identifier field. 
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Figure 3 Identifier Fieid 


The parity information is calculated using a mixed parity algorithm that 
prevents all bits being recessive or dominant. 

2.2 Response The response frame is always transmitted by the slave task (this can be 

Frame the slave in the master). It consists between 2, 4 or 8 data fields and a 

checksum field. The data fields consist of 8 bits of data transmitted LSB 
first. The checksum contains an inverted modulo 256 sum over all data 
bytes. 


2.3 Sleep Mode A reserved Sleep Mode Frame with a fixed 0x80 identifier was specified 
Frame the original version of the LIN specification. In version 1.2 or later the 

Sleep Mode Frame has been removed and replaced by reserved 
identifiers, which are described in section 2.4. However, as the demo 
software was developed to the original specification it uses the fixed 
identifier 0x80 as the Sleep Mode Frame. 


NOTE: Any slave node can bring the bus out of sleep mode (by transmitting the 
WAKEJJP signal). However, it is only the master that is allowed to put 
the network to sleep. 


Refer to LIN specifications for further details. 
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2.4 Reserved 
Identifiers 

2.4.1 Command 
Frame Identifiers 


2.4.2 Sieep Mode 
Command 


2.4.3 Extended 
Frame identifier 
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Local Interconnect Network Bus (LIN) 
Reserved Identifiers 

Version 2.1 of the LIN specification contains reserved identifiers; 
Command frame identifiers and Extended frame identifiers. 


Two COMMAND FRAME IDENTIFIERS have been reserved to 
broadcast general command requests from master to all bus 
participants. The frame structure is identical to regular 8-byte message 
frames with the following reserved IDENTIFIER FIELDS: 

0x3C - Download frame 

0x7D - Upload frame 

The download frame is used to send commands and data from master 
to the slave nodes. The upload frame is used to trigger one of the slave 
nodes (being addressed by a prior download frame) to send data to the 
master. 

Additionally, command frames with their first byte containing 0x00 to 
0x7F are reserved for specific use by the LIN consortium. The remaining 
frames are free to be assigned by the user. 

The SLEEP MODE COMMAND is used to broadcast the sleep mode to 
all bus nodes. The SLEEP MODE COMMAND is a download 
COMMAND FRAME with the first data byte set to 0x00 

Two EXTENDED FRAME IDENTIFIERS have been reserved to allow 
the embedding of user defined message formats and for future 
expansion without violating the specification. The frame structure is 
identical to regular 8-byte message frames with the following reserved 
IDENTIFIER FIELDS: 

OxFE - User defined extended frame 

OxBF - Future LIN extension 

The identifier can be followed by an arbitrary number of LIN BYTE 
FIELDS. The frame length, communication concept and data content are 
not specified. Also, the length coding within the ID field does not apply 
to the EXTENDED frame identifiers. 
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3 SAE Demo Description 


The LIN Demo consists of a single master node and twelve slave nodes 
mounted on a ‘clock face’ (see Figure 4 for details). The master controls 
all slave nodes. It schedules messages that flash the slave’s LEDs in a 
predetermined sequence. In addition, on a request from the master, 
each slave node responds with a status messages. The status returned 
is the value of 2 HEX switches mounted on the slave hardware. The 
value can be changed, in real time, and monitored on the LIN and CAN 
buses. 

The demo has several modes of operation that are described below. 
Each mode is selected by a CAN message or by a switch on the master 
node, when operated in standalone mode. Finally, the master node can 
be removed and the demo can be driven using a VCT LINspector 
configured in emulation mode. 



Figure 4 Clock Face Hardware 
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NOTE: 


3.1 Demo 
Configuration: 

3.1.1 Standard: 

3.1.2 Standalone: 

3.1.3 Emulator: 

3.2 Modes of 
operation: 

3.2.1 Default 
Mode: 

3.2.2 Broadcast 
Mode: 
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SAE Demo Description 
Demo Configuration: 

The LINspector is a cost effective LIN tool that can be used in a variety 
of situations, including development, testing and verification. It is driven 
from a LIN configuration description file, which contains all details of the 
network. It can be used to monitor all traffic, provide detailed timing 
information and advanced triggering functions. Additionally, it enables 
basic and advanced emulation features that allow the user to ‘replace’ 
any number of nodes on the network. Refer to VCTs web page for more 
details. The URL is http://www.vct.se 


Software on master node used to control the demo. 

VCT LINspector used to monitor all bus activity. 

CAN node used to activate different demo modes and display status 
messages. 

Software on master node used to control the demo. 

VCT LINspector used to monitor bus activity. 

HEX switches on master used to select modes 

VCT LINspector used to control the demo and display all bus activity. 


In this mode, the master sequentially transmits messages to the slave 
nodes that control their LEDs. The slaves respond with the settings of 
their HEX switches. The switch settings are translated to a CAN 
message and transmitted onto the CAN bus. If a slave node is removed 
a NO_NODE code (0x00) is transmitted on to the CAN bus 


In this mode, the master periodically transmits a messages that each 
slave node simultaneously receives. The transmitted messages switch 
on the slave’s LEDs. The master node controls the LED pattern. 
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3.2.3 Ident Mode: This mode is primarily used to set-up the demo. The master transmits a 

broadcast message that each slave node receives. On reception of this 
message, the slaves output their IDs to the LEDs. 


3.2.4 Sleep Mode: This is the demo’s low power mode. The master transmits a sleep 

command that signals to the slaves to enter sleep mode by disabling 
their voltage regulators. The master also enters sleep mode once the 
sleep command has been successfully transmitted. Any slave can 
wake-up the demo by pressing the red buttons around the perimeter of 
the ‘clock face’. The slave node that is woken up wakes up the entire 
network by transmitting a wake-up sequence on the LIN bus. 

The LIN physical interface (MC33399) supports wake-up from the bus 
and from an external source. On the detection of a valid wake-up signal, 
the physical interface drives its inhibit output signal low, enabling an 
external voltage regulator (if this feature is used). Alternatively, the 
inhibit output can be used to drive the IRQ of the microcontroller. Refer 
to MC33399 data sheet for specific application details. 


A simple data driven messaging scheme was used to control the demo. 
Each slave node is statically configured to recognize 3 LIN message 
identifiers. These are a NodeX_Write, a NodeX_Read and a Broadcast 
message, where X denotes the node number. This allows the master to 
transmit commands and data to individual nodes and for each node to 
transmit status responses back to the master. The broadcast message 
identifier is common to each slave node. It allows the master to transmit 
data to all the nodes simultaneously. Table 1 lists the messages that 
were used for the demo. 


Table 1 LIN Messages 


Message Name 

Message ID 
(LIN ID) 

Slave Response 
Source 

Slave Response 
Destination 

Description 

Model _Write 

LINMsgOI (OxC1) 

Master 

SlaveJD 1 

Master transmits node1 control 
command 

Node2_Write 

LINMsg02 (0x42) 

Master 

SlaveJD 2 

Master transmits node2 control 
command 

Node3_Write 

LINMsgOS (0x03) 

Master 

SlaveJD 3 

Master transmits node3 control 
command 

Node4_Write 

LINMsg04 (0xC4) 

Master 

SlaveJD 4 

Master transmits node4 control 
command 

Node5_Write 

LINMsgOS (0x85) 

Master 

SlaveJD 5 

Master transmits node5 control 
command 

Node6_Write 

LINMsgOe (0x06) 

Master 

SlaveJD 6 

Master transmits node6 control 
command 


3.3 LIN 

Messaging 

Scheme 
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LIN Messaging Scheme 


Table 1 LIN Messages 


Message Name 

Message ID 
(LIN ID) 

Slave Response 
Source 

Slave Response 
Destination 

Description 

Node7_Write 

LINMsg07 (0x47) 

Master 

SlaveJD 7 

Master transmits node7 control 
command 

Node8_Write 

LINMsg08 (0x08) 

Master 

SlaveJD 8 

Master transmits node8 control 
command 

Node9_Write 

LINMsg09 (0x49) 

Master 

SlaveJD 9 

Master transmits node9 control 
command 

Model 0_Write 

LINMsgOA (OxCA) 

Master 

SlaveJD 10 

Master transmits 
trol command 

nodelO con- 

Model 1_Write 

LINMsgOB (0x8B) 

Master 

SlaveJD 11 

Master transmits 
trol command 

nodell con- 

Model 2_Write 

LINMsgOC (0x4C) 

Master 

SlaveJD 12 

Master transmits 
trol command 

node12 con- 

Model _Read 

LINMsg11 (0x11) 

Model 

Master 

Slave transmits 
back to master. 

status data 

Node2_Read 

LINMsg12 (0x92) 

Node2 

Master 

Slave transmits 
back to master. 

status data 

Node3_Read 

LINMsgIS (0xD3) 

Node3 

Master 

Slave transmits 
back to master. 

status data 

Node4_Read 

LINMsg14(0x14) 

Node4 

Master 

Slave transmits 
back to master. 

status data 

Node5_Read 

LINMsgIS (0x55) 

Node5 

Master 

Slave transmits 
back to master. 

status data 

Node6_Read 

LINMsgie (0xD6) 

Node6 

Master 

Slave transmits 
back to master. 

status data 

Node7_Read 

LINMsg17(0x97) 

Node7 

Master 

Slave transmits 
back to master. 

status data 

Node8_Read 

LINMsg18 (0xD8) 

Node8 

Master 

Slave transmits 
back to master. 

status data 

Node9_Read 

LINMsg19 (0x99) 

Node9 

Master 

Slave transmits 
back to master. 

status data 

Model0_Read 

LINMsglA(OxlA) 

Model 0 

Master 

Slave transmits 
back to master. 

status data 

Model1_Read 

LINMsgIB (0x5B) 

Nodell 

Master 

Slave transmits 
back to master. 

status data 

Model2_Read 

LINMsgie (0x9C) 

Model 2 

Master 

Slave transmits 
back to master. 

status data 

Broadcast 

LINMsgOF (0x80) 

Master 

All slave nodes 

Master transmits 
all slave nodes 

command to 


The messages selected for the demo are all 2 bytes long. The first byte 
is a command byte and the second is data. Table 2 details the 
NodeX_Write Message Format. 
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NodeX Write Message Format 

Table 2 NodeX Write Messages 


Identifier = See tabie 


Byte1 = Command Byte 


Byte2 = LED Pattern 


Write Message Command Byte 

Command 

Code 

SLAVE_LEDS_COMMAND 

0x01 

CLOCK_LEDS_COMMAND 

0x03 


Broadcast_ Message Format 


Table 3 Broadcast Messages 


Identifier = See tabie 


Byte1 = Command Byte 


Byte2 = LED Pattern 


Broadcast Message Command Byte 

Command 

Code 

BROADCAST_COMMAND 

0x02 

IDENT_COMMAND 

0x04 

SLEEP_COMMAND 

0x80 


NOTE: LED pattern sent with command byte. Pattern written to slave node 

LEDs. IDENT and SLEEP commands the LED pattern is ignored. 


NodeX Read Message Format 


Table 4 NodeX Read Messages 


Identifier = See tabie 


Byte1 = NodelD 


Byte2 = Hex Switch 


The message format was adopted to allow flexibility within the demo. 
Additional commands can be added without too much effort. The slaves 
can also easily decode the various commands and act accordingly. 
Another benefit is that the master node software has total control over 
the LED pattern that the slaves output. In order to change the LED’s 
sequence, only the master software has to be changed. 
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Hardware Description 


In actual LIN applications a signal-based messaging scheme should be 
adopted. Refer to section Section 4.1 Freescale LIN Drivers and API for 
details of Motorola’s signal-based LIN API. 


3.4 Hardware 
Description 


The demo consists of 13 LIN nodes; a single master and 12 slaves. The 
hardware for each node is identical as shown in the schematic (see 
appendix for schematic details). Identical hardware was used to enable 
a universal master/slave board to be designed. This makes the slaves 
more flexible and reduces demo cost. The main drawback of adopting 
this common solution is that the microcontroller required for the master 
node, MC68HC908AZ60, is not suitable for slave nodes because of its 
additional functionality (particularly CAN). This makes it too expensive 
for a typical slave node. Figure 5 shows a block diagram of the hardware. 
Table 5 details more suitable slave microcontrollers. Contact Freescale 
for further details (www.mcu.motsps.com). 
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Figure 5 Master/Slave Hardware 
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The hardware has several functions that make the design flexible and 
suitable for other general CAN and LIN applications. 


Table 5 LIN Slave Devices 


LIN Slave MCUs 

Device 

ROM 

FLASH 

RAM 

Features 

68HC908JK3 

- 

4K 

128 

Timer, PWM, ATD 

68HC908JL3 

- 

4K 

128 

Timer, PWM, ATD 

68HC908JK1 

- 

1.5K 

128 

Timer, PWM, ATD 

68HC08AB16 

16K 

- 

512 

Timer, PWM, ATD, SCI, SPI 

68HC908EY8 

- 

8K 

256 

Timers, ATD, SPI, Enhanced SCI 


LIN Slave Hyperintegratlon/Mechatronics 

Device 

ROM 

FLASH 

RAM 

EEPROM 

Features 

68HC05PV8 

8K 

- 

192 

128 

Timer, PWM, A/D, OSC, HV I/O, OP-Amp, Phy l/F 

68HC805PV8 

- 

8K 

192 

128 

Timer, PWM, A/D, OSC, HV I/O, OP-Amp, Phy l/F 

33393TM 



64 

Ik 

Timer, Osc, 2x175mA H-Bridge, Mechatronic package 


3.4.1 Monitor The hardware has the additional circuitry included to allow the 

Mode microcontroller to communicate with a PC via its monitor mode. This 

enables in-circuit Flash programming and simple debugging to be 
performed. Hiware’s MON08 target was used in the application 
development. 


3.4.2 LIN Physical 

Interface 

(MC33399) 


The MC33399 was used in the demo. This interface is a serial link bus 
interface designed to provide bi-directional, half-duplex communication 
interfacing in automotive applications. It is similar to the IS09141 
interface, but has additional features specific to the LIN protocol. These 
features are wake-up from the LIN bus, wakeup from an external source 
and slew rate control to reduce EMI emissions. Refer to the MC33399 
data sheet for a detailed description and application diagrams. 


3.4.3 CAN In addition to the LIN interface, each node has a CAN physical interface 

Physical Interface (MC33388). This is required for the master node, as a simple CAN to LIN 

gateway is implemented. 


3.4.4 LEDs and HEX Each node has 8 LEDs (4 red and 4 green) and 2 HEX switches. The 

Switch interface LEDs are driven directly from Port B, configured as output, and used to 

demonstrate the LIN protocol and sequencing of messages from the 
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Freescaie LIN Drivers and API 

master. The switches are input to Port D and allow each node to have a 
status and identifier value that can be changed in real time and 
transmitted on the LIN bus. 

The LEDs and switches are positioned at the edge of the boards and can 
easily be removed and the board used to drive an actual application. For 
example, the port lines that interface to the LEDs and switches could be 
connected to a power drive board and could be used to control motors 
of a mirror module. This makes the board very flexible and allows quick 
prototyping of LIN applications. 


3.4.5 

Components used 


MC68HC908AZ60 - General purpose flash MCU with CAN. 
MC33399 - LIN Physical interface. 

MC33388 - Low speed, fault tolerant, CAN physical interface. 


4 Software Description 


The demo comprises a single master and 12 slave nodes. The master 
software is responsible for scheduling LIN messages, providing a CAN 
to LIN gateway and general communications. The slave software 
interrogates all header frames transmitted on the bus and either receives 
a response frame from another slave or transmits a response frame on 
to the bus. Each slave waits for a pre-configured message, decodes the 
command and either outputs the data to its LED port, if it is a 
NodeX_Write or broadcast message, or transmits a status message to 
the LIN network, if a NodeX_Read message was detected. The code for 
each slave is practically identical, the only difference being the 
messages configured are specific to individual nodes. See Table 1 for 
details. 

The master and slave code implementations both use the Freescale 
FIC08 LIN low level drivers to manage all the LIN communications. The 
drivers and the application code for the demo are described in this 
section. All data flow diagrams and flow charts are included. Refer to the 
appendix for code listing. 


4.1 Freescale jhe driver provides the full LIN protocol eliminating the application code 
LIN Drivers and implementing the LIN low level kernel. The user interfaces with the 

drivers, statically at compile time and dynamically at run time through an 
API. Two versions of the drivers exist: one with a custom Freescale API 
and the second with the LIN API. The project used the Freescale API 
drivers. 
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The Freescale API is entirely message based. The message identifiers 
for a specific node are configured at compile time through header files. 
The application accesses the data transmitted using the LIN_GetMsg() 
and LIN_PutMsg() services. The application retrieves or transmits the 
data associated with the identifier. (The address of a buffer that contains 
the data to be transmitted or received and the message identifier are 
passed to the driver, by the application). The drivers are easily used with 
no additional tools and are linked with the application code. 

The main difference of the LIN API is that it is signal based. The 
application code does not access the entire message data, but only 
specific signals. A signal consists of one or more bits of data. The drivers 
provide services to access particular signals of varying lengths. (1 bit, 
2-8bits and 9-16bits). In order to use the drivers an additional description 
file is required that describes all the signals that are specific for a 
particular node. This description file is then converted to header files (an 
additional tool is required for this) and included with the application. 
Every node on the network requires a separate description file that 
contains its specific signals. This file is also used with the LINspector tool 
for development and evaluation. The LIN API has provision to connect 
to several hardware interfaces (more than one SCI). 

The LIN Drivers are currently available for the HC05, HC08 and HC12 
families of microcontrollers. Details of the HC08 implementation are 
given below. 


Node 

LINBaud 

Rate(bps) 

MCU bus 
frequency 

MCU load 

RAM 

(bytes) 

ROM 

(bytes) 

Stack 

(bytes) 

Master 

20000 

4 

<9% 

23 

1391 

<34 

Slave 

20000 

4 

<5%/6% 

20/21 

1071/689 

<34/19 


Note1: Figures exclude per message overhead 
Note2: Freescale API/LIN API 


Contact Freescale Software Systems for further information. 
software.systems@www.freescale.com 
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4.1.1 Static 
Configuration 


4.1.2 Driver API 


4.1.2.1 LIN Init: 
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The drivers are statically configured through 2 header files, lincfg.h and 
linmsgid.h. The lincfg.h file is used to provide general LIN configuration 
information, such as baud rate and timer pre-scalers. The information in 
this file is the same for each node on the network, assuming they are all 
the same target hardware. The linmsgid.h file is used to define the 
node’s messages and whether they are to be received or transmitted. 
This file is usually unique to every node on the network. For further 
details refer to the LIN drivers manual and the demo configuration files. 


The API is the interface with the drivers. The application code calls the 
run time services provided by the driver, during execution. The services 
used in the demo software are described below. Refer to driver manual 
for full descriptions of the Freescale and LIN API. 

The LINJnit service performs initialization of the driver. The function 
must be called before any other API service call is made. The service 
initializes the following functions: 

• Sets baud rate (Information entered in lincfg.h file) 

• Assigns physical interface pins 

• Sets Tx to idle state 

• Clears all error flags and counters 

• Clears all data buffers 

• Change state of drivers to run 

• Initializes all variables 


Syntax: 

Applicable: 

Parameters: 

Return: 


unsigned char LINJnit (void); 
Master, Slave 
None 
LIN OK 
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4.1.2.2 The LIN_GetMsg service retrieves the current content of the specified 

LIN_GetMsg: message buffer to an application defined buffer 


Syntax: 

Applicable: 

Parameters: 


unsigned char LIN_GetMsg (unsigned char Msgid, 
unsigned char * Data); 

Master, Slave 

Msgid - Message identifier 

Data - Pointer to memory buffer where received data is to 
be stored. 


Return: LIN_OK, LIN_NOJD, LINJNVALIDJD and 

LIN MSG NODATA 


4.1.2.3 The LIN_PutMsg service transmits current contents of specified 

LIN_PutMsg: message buffer to an application specified message buffer. 


Syntax: 

Applicable: 

Parameters: 


unsigned char LIN_PutMsg (unsigned char Msgid, 
unsigned char * Data); 

Master, Slave 

Msgid - Message identifier 

Data - Pointer to memory buffer where data is to be 
transmitted. 


Return: LIN_OK, LIN_NOJD and LINJNVALIDJD 


4.1.2.4 The LIN_RequestMsg service transmits the message identifiers header 

LIN_RequestMsg: frame 


Syntax: 

Applicable: 

Parameters: 

Return: 


unsigned char LIN_RequestMsg (unsigned char Msgid); 
Master 

Msgid - Message identifier 

LIN_OK, LIN_REQ_PENDING and LIN_MSG_SLEEP 
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Software Description 
Master code impiementation 

The LIN_MsgStatus service returns the current status of the 
specified message buffer. 


Syntax: 

Applicable: 

Parameters: 

Return: 


unsigned char LIN_MsgStatus (unsigned char Msgid); 

Master, Slave 

Msgid - Message identifier 

LIN_NOJD, LIN_OK, LIN_MSG_NOCHANGE and 
LIN MSG NODATA 


4.2 Master code 
implementation 


The master software has 2 main tasks that schedule LIN messages 
and provide a CAN to LIN gateway. The scheduler operates from a 
periodic tick, driven from Timer B overflow, and transmits a header 
frame everyl 50ms. The gateway function is driven from the CANRx 
interrupt and either changes the demo mode or transmits a LIN 
message to a specific slave node. Figure 6 shows the data flow 
diagram of the master software. 



Figure 6 Master Data flow Diagram 
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4.2.1 Demo Modes As discussed the demo has several modes of operation that are user 

selectable. The mode is controlled by a CAN message or by the HEX 
switch on the master PEC, when operated in standalone mode. The 
mode can be changed at any time. Table 6 shows the CAN 
messages and switch positions that select different modes. 


Table 6 Mode Selection Table 


Mode Selection Table 

Mode 

CAN Message 

Switch Position 

Default 

ID 0x00, Byte0=0x0E, 0x00 

0 

Broadcast 

ID 0x00, Byte0=0x0E, 0x01 

1 

Ident 

ID 0x00, Byte0=0x0E, 0x02 

2 

Sleep 

ID 0x00, Byte0=0x0E, 0x03 

3 


The mode select is controlled in the ScheduleMessage function. The 
software reads a demomode control variable and depending on its 
value calls a default message handler, broadcast message handler, 
ident message handler or a sleep message handler. The control 
variable is initialized to DEFAULT mode out of reset, but can be 
updated directly from the hex switch (on Port D) or from a CAN 
message. 
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Each mode and its software are described below: 

4.2.1.1 Default mode In default mode the software executes in a loop that sequentially 

transmits 2 messages to each slave node. See Table 7 for sequence. 
The first message is a NodeX_Read message that requests a status 
response from the slave to indicate that it is present. If the master 
does not receive the slave response within a 10mS timeout it is 
assumed that the node is not present and a NO_NODE code (0x00) 
is transmitted on the CAN bus. The second message transmitted 
(assuming a node is present) is a NodeX_Write message that 
transmits a command byte and a data byte to a specific slave. The 
slave decodes the command and outputs the data to its LED port. 

The status response message is checked to see if it has changed 
since the last interrogation. If it has changed it is translated to a CAN 
message and transmitted onto the CAN bus. The status information 
is updated before the function is exited. 

NOTE: The CAN transmission is not performed if the demo is in standalone 

mode. 

The scheduler software exits this function then waits in the main loop 
before transmitting to the next node in the sequence. The node 
number to be transmitted is controlled in the TIMBOVFJSR. See 
main loop for further details. 
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Table 7 Schedule Sequence 


Default Message Sequence 

Node Number 

Data 

12 

ALL_LEDS_ON 

1 

RED LEDS ON 

11 

GREEN_LEDS_ON 

2 

RED LEDS ON 

10 

GREEN_LEDS_ON 

3 

RED LEDS ON 

9 

GREEN_LEDS_ON 

4 

RED LEDS ON 

8 

GREEN_LEDS_ON 

5 

RED LEDS ON 

7 

GREEN_LEDS_ON 

6 

ALL_LEDS_ON 

7 

RED LEDS ON 

5 

GREEN_LEDS_ON 

8 

RED LEDS ON 

4 

GREEN_LEDS_ON 

9 

RED LEDS ON 

3 

GREEN_LEDS_ON 

10 

RED LEDS ON 

2 

GREEN_LEDS_ON 

11 

RED LEDS ON 

1 

GREEN_LEDS_ON 

REPEAT 

REPEAT 


The default message table shows the order that the nodes are written 
to and the data that is transmitted. 
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Figure 8 Default Mode Flow Diagram 
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Figure 9 Default Transmit Function 
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4.2.1.2 Broadcast In this mode, the master software periodically transmits a broadcast 

Mode message which is received by every slave node. The first byte of the 

message contains the broadcast command, and the second byte 
contains the data byte that each slave outputs to its LED port. A 
single 1 is shifted through the data byte from bitO to bit7, the 
sequence is then reversed and repeated. The data bytes to be 
broadcast are stored in a lookup table. See Table 8 below for details. 



NOTE: A lookup table was used to allow the pattern sequence to be changed 
with ease 
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Figure 10 Broadcast Mode Flow Diagram 
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4.2.1.3 IDENT Mode In this mode, the master software periodically transmits a broadcast 

message with an IDENT command. Each slave node receives this 
command and outputs its individual identifier to its LED port. 

NOTE: The slave is pre-programmed with its identifier. 



Figure 11 Ident Mode Flow Diagram 
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4.2.1.4 Sleep Mode In this mode, the demo enters its low power state by switching off its 

voltage regulator. The master node transmits a SLEEP command 
that is received by all slave nodes. Once the SLEEP command has 
been successfully transmitted, the master disables its voltage 
regulator by driving the LIN interface into its Sleep mode. The 
software then waits in an infinite loop until the regulator is disabled. 
The master is the only node that can issue a SLEEP command. 

The master is woken by a wake-up request initiated by one of the 
slave nodes. The LIN l/F device recognizes a specific wake-up 
message driven onto the bus. The LIN l/F brings the node out of 
sleep mode by turning on the voltage regulator. 



Figure 12 Sleep Mode Flow Diagram 


AN2103 

For More Information On This Product, 
Go to: www.freescale.com 




Freescale Semiconductor, Inc 


Freescale Semiconductor, Inc. 


Application Note 


4.2.2 CAN The master software also provides CAN communication and 

Communication implements a simple CAN to LIN gateway. 

The CAN receive and the transmit functions are described below: 

NOTE: CAN communication do not occur when the demo is configured in 
standaione mode. 

4.2.2.1 Receiving The receiver function is interrupt driven. If a message passes the 

CAN Messages CAN filters it is written into the CAN receive buffer and a receive 

interrupt request is issued. The CANRx ISR sets a msgrxd flag that 
indicates that a new message has been received and clears the 
interrupt flag to enable further interrupts. The main routine, discussed 
below, polls the msgrxd flag, waiting until it is set. When a new CAN 
message is received, the code calls a MsgHandlerTable (array of 
pointers to functions) and jumps to the appropriate 
MsgHandlerFunction. The function that is executed is dependent on 
the first byte of the received CAN message. This byte, masked off 
with OxOF, determines the index of the MsgHandlerTable and 
subsequently the handler that the code executes. 

4.2.2.2 CAN Message The basis of the CAN communication and gateway function is 

Handlers performed using a series of message handlers. These are described 

below: 


A.2.2.2.1 Common This handler is used to transmit a LIN message to a particular slave 

Message Handler node. The node that the message is transmitted to is determined by an 

index (CanMsgIndex). The index is calculated from the CAN message 
that was received. The slaves receive the LIN messages and control 
the external button LED around the circumference of the ‘clock face’. 


X denotes node number 
(0 <=x>=12) 


Figure 13 Message Handler (1-12) flow diagrams 
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A.2.2.2.2 See sleep mode description 

SleepHandler 

4.2.2.2.3 ModeSelecf This function decodes the CAN mode select message and writes the 

Handler appropriate value to the demomode variable. 



Figure 14 ModeSelectHandler flow diagrams 


42.2.2.4 This handler consists of the function prototype. This is included for 

DefaulfHandler expandability and to ensure that the code does not ‘run away’ even 

if an invalid entry in the message handler vector table is accessed, 
i.e. all unused entries in the table jump to DefaultMessage handler. 
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4.2.2.3 Transmitting The CAN transmitter function is called from the initialisation and 

CAN Messages default mode functions. The identifier and data to be transmitted are 

written to TxBufferO and transmitted when the bus is idle. The 
function that transmits the message, TxCANBuffer(), receives a 
pointer to a structure that contains the id and data to be transmitted 
and the TxBuffer number as arguments. 



Figure 15 CAN Transmit flow diagrams 
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Main Loop 
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The main routine is essentially a simple infinite loop that waits for 
either a msgrxd system flag to be set or a loopcontrol system flag to 
be cleared. The msgrxd flag is set in the CANRx_ISR when a CAN 
message is received. If the flag is set, the MsgHandlerTable is called 
and the appropriate handler routine executed as described in the 
Receiving CAN Messages section. The loopcontrol flag is cleared 
periodically in the TIMBOVFJSR, which overflows every 150ms. 
When the flag is cleared, the ScheduleMsg function is called and the 
selected mode executed. Once the CAN message is received or the 
mode executed, the main function resets the appropriate flags and 
returns to the infinite loop waiting for a flag to change again. 

The main loop also performs initialization, by calling the appropriate 
initialization function, before the infinite loop is entered. Initialisation 
of the MCU registers, LIN drivers and application is also performed. 
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Figure 16 Main Loop fiow diagram 
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4.3 Slave Code 
description 


The slave code is entirely message driven. The software for each 
node is practically identical, the only difference being the messages 
the node is configured to recognize and the nodelD. 

The individual slaves are configured to react to 3 preprogrammed 
message identifiers: a NodeX_Write, a NodeX_Read and a common 
broadcast message (NodeX_Write message that every slave is 
programmed to receive). See Table 1 for details. Each slave 
monitors every header that the master drives on the bus, but only 
reacts to its configured identifiers. If a NodeX_Write message is 
detected, it receives the message data, decodes the command, and 
either writes to its LED output port or the external output LED or 
enters SLEEP mode. If a NodeX_Read message is detected, the 
slave automatically transmits its status information bytes (i.e. Its ID 
and the HEX switch settings) on to the LIN bus. 

Received messages are handled in exactly the same way as the 
master code handles CAN messages. When a new LIN message is 
received (NodeX_Write) the code calls a MsgHandlerTable (array of 
pointers to functions) and jumps to the appropriate 
MsgHandlerFunction. 


Periodic 



Figure 17 Slave code data flow diagram 
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4.3.1 Slave Code The slave code’s main function is very similar to the master’s in that 

Main Function it performs some initialization before entering an infinite loop. During 

an iteration of the loop, the code updates the status message buffer 
by writing the HEX switch settings to the NodeX_Read message 
buffer using the LIN_PUTMsg() service and checks to see if a new 
received message has been detected. If a new message has been 
detected, the Msg Handler!able is called and the appropriate handler 
function is executed. Several housekeeping tasks are also 
performed in the main loop, such as control of timeouts etc. Once the 
iteration is complete, the code jumps back to the start of the loop and 
performs the tasks again. 
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Figure 18 Main Loop fiow diagram 
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4.3.2 Receiving UN 
messages 


Each slave node is configured to receive 2 LIN messages: a 
broadcast message and a NodeX_Write message. The first byte of 
the message is a command. The main function polls the message 
status flags of the configured messages and transfers the received 
data to the application receive buffer, MsgRcvd, when a valid 
message is received. The command byte is decoded and the 
appropriate handler function is executed. Each message handler is 
described below: 


4.3.2.1 Rotating This handler is entered when the demo is configured for default mode 

Handler (SLAVE_LEDS command transmitted by the master). The handler 

decodes the LED data received, to see if it is to illuminate the RED 
or GREEN LEDs, resets the appropriate time out counter and then 
outputs the data to its LED output port. 
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Figure 19 Rotating Message Handier fiow diagram 
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4.3.2.2 Broadcast This handler is entered when the demo is configured for broadcast 
Handler mode (BROADCAST command transmitted by the master). The 

handler disables the time out and then outputs the data to its LED 
output port. 



Figure 20 Broadcast Message Handler flow diagram 

4.3.2.3 External This handler is entered when the demo is configured for external 

Handler mode (CLOCK_LEDS_COMMAND command transmitted by the 

master). The handler enables the time out and then outputs the data 
to its external output port (PortE, bit4) 



Figure 21 External Message Handler flow diagram 
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4.3.2.4 Identify This handler is entered when the demo is configured for IDENT mode 

Handier (IDENT command transmitted by the master). The handler disables 

the time out and then outputs the data to its LED output port 



Figure 22 Identify Message Handier fiow diagram 


4.3.2.5 Defauit 
Handier 


This handler consists of the function prototype. This is included for 
expandability and to ensure that the code does not ‘run away’ even 
if an invalid entry in the message handler vector table is accessed. 
I.e. All unused entries in the table jump to DefaultMessage handler. 


4.3.2.6 SleepHandler See sleep mode description 
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4.3.3 Sleep mode is the demo’s low power mode. It is entered when the 

Sleep Mode master transmits the SLEEP identifier (0x80). Each slave receives 

the command and jumps to the sleep message handler. The handler 
disables the voltage regulator by driving the LIN l/F into sleep mode. 

Any node can be brought out of sleep mode by an external switch 
(switches around the circumference of the clock face) or a wake-up 
message (see protocol specification for details) detected on the LIN 
bus. The slave that is woken up transmits the wake-up message onto 
the bus, which wakes up the master and the other nodes. 

Each slave distinguishes between a wake-up (switch on voltage 
regulator) and a normal power up sequence, by detecting if the 
master is present on the bus (master will be communicating on bus 
for standard power up sequence). The master transmits an ALIVE 
(OxOF) message every 150ms to signal its presence. If a slave 
detects an ALIVE message it assumes that it is a power up 
sequence. If the ALIVE is not detected within 200ms the slave 
assumes that it has woken up and subsequently transmits a wake-up 
message to the network. 


AN2103 


For More Information On This Product, 
Go to: www.freescale.com 



Freescale Semiconductor, Inc 


Freescale Semiconductor, Inc 


Code Listings 
Master Code - MasterOS.C 


5 Code Listings 


5.1 Master Code - MasterOS.C 


j ******************** 

File Name 

Engineer 

Location 

Date Created 

Current Revision 

Notes 


MASTEROS.C 

R29414 

EKB 

07/02/2000 


Copyright (c) 


$Revision; 1.0$ 

Master software for the LIN Demo 


***************************************************************************************** 

Freescal e reserves the right to make changes without further notice to any 

Product herein to improve reliability, function or design. FreeSCal 6 does not 

assume any liability arising out of the application or use of any product, 

circuit, or software described herein; neither does it convey any license 

under its patent rights nor the rights of others. FreeSCal 6 products are not 

designed, intended, or authorized for use as components in systems intended for 

surgical implant into the body, or other applications intended to support life, 

or for any other application in which the failure of the FreeSCal 6 product 

could create a situation where personal injury or death may occur. Should 

Buyer purchase or use Freescal 6 products for any such unintended or 

Unauthorized application. Buyer shall idemnify and hold Freescal 6 and its 

officers, employees, subsidiaries, affiliates, and distributors harmless 

against all claims costs, damages, and expenses, and reasonable attorney fees 

arising out of, directly or indirectly, any claim of personal injury or death 

associated with such unintended or unauthorized use, even if such claim alleges 

that Freescal e was negligent regarding the design or manufacture of the part. 

Freescal e and the Freescal e logo* are registered trademarks of Freescale Seml conductor, Inc 

************************************************************************************y 


/************************* System Include Files * 
#include <linapi.h> 

/************************* Project Include Files 

#include <master08CodeReview.h> 

#include <common.h> 

#include <port.h> 

#include <timer.h> 

#include <sim.h> 

#include <si.h> 

#include <kbd.h> 

#include <mscan08.h> 


/*************************** Constants ********** 
/* Slave Node Message array */ 
const SlaveNodeMsgType SlaveMsg [] = 

{ 

{OxOF,OxOF}, 

{0x01,0x11}, 

{0x02,0x12}, 

{0x03,0x13}, 


// LIN Drivers Header file 

// Master08 header file 

// Common data structure 

// Port register definitions 

// Timer register definitions 

// SIM Register definitions 

// Serial Interface Register definitions 

// Keyboard wakeup Register definitions 

// msCAN Register definitions 




// Broadcast message */ 

// Nodel Write messagelD, Nodel Read messagelD 
// Node2 Write messagelD, Node2 Read messagelD 
// Node3 Write messagelD, Node3 Read messagelD 
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{0x04,0x14}, 

// 

Node4 Write messagelD, 

Node4 Read messagelD 

{0x05,0x15}, 

// 

Nodes Write messagelD, 

Nodes Read messagelD 

{0x06,0x16}, 

// 

Node6 Write messagelD, 

Node6 Read messagelD 

{0x07,0x17}, 

// 

Node? Write messagelD, 

Node? Read messagelD 

{0x08,0x18}, 

// 

Node8 Write messagelD, 

Node8 Read messagelD 

{0x09, 0x19}, 

// 

Node9 Write messagelD, 

Node9 Read messagelD 

{ OxOA,OxlA}, 

// 

NodelO Write messagelD, 

. NodelO Read messagelD 

{OxOB,OxlB}, 

// 

Nodell Write messagelD, 

. Nodell Read messagelD 

{OxOC,OxlC} 

// 

Nodel2 Write messagelD, 

. Nodel2 Read messagelD 


}; 

/* Broadcast table settings */ 
const tU08 BroadcastTable [] = 

{ 

0x01, 

0x03, // Data bytes transmitted when in broadcast mode 

0x07, 

OxOF, 

OxlF, 

0x3F, 

0x7F, 

OxFF 

}; 

^****************************************************************************** 

Message handler vector table 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^ 


void (* const MsgHandlerTable[])() = 

{ 

CommonMsgHandler, 

CommonMsgHandler, // If required different handlers can be used 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

CommonMsgHandler, 

SleepHandler, 

ModeSelect, 

DefaultHandler 

}; 


/************************* Global Variables ******* 

SlaveMsgBufferType CurrentSlaveStatus [12] ; 
DemoModeType_t DemoMode = DEFAULT; 
tFLAG SystemFlags; 
tTXBUF StatusMsg; 

tU08 MsgWriteBuf [2]; 

tU08 Scheduleindex = 0x01; 

tU08 AltScheduleIndex = 0x00; 

tU08 Broadcastindex = 0x00; 

tU08 MsgReadBufl[2] = {0x00,0x00}; 

tU08 MsgReadBuf2[2] = {0x00,0x00}; 

tU08 CanMsgIndex = 0x00; 

tU08 TimeoutCount = 0x00; 

tU08 LoopControlTime = 0x00; 


// Current slave node status 

// Current demo mode (DEFAULT,BROADCAST,IDENT,SLEEP) 
// System flags 

// Temp write buffer used with LIN Drivers 
// Slave node index 

// Broadcast control index 

// Temp read buffer used with LIN Drivers 

// Timeout counter for slave nodes. Set at Sms 
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! •k'k'k-k'k'k'k'k'k 


/* Points 

#define 

AZ 

#define 

AZ 

#define 

AZ 

#define 

AZ 

#define 

AZ 

#define 

AZ 


**************** #Defines ****** 
to register block in memory */ 
60_PORT (*(tPORT*) (0x0000)) 
60_TIMER (*(tTIMER*) (0x0020)) 
60_SI (*(tSI*) (0x0010)) 

60_SIM (*(tSIM*) (OxFEOO)) 

60_KBD (*(tKBD*) (OxOOlA)) 
60_MSCAN08 (*(tMSCAN*) (0x0500)) 


Function Name : Main 

Engineer : R29414 

Date : 09/02/2000 


Parameters 

Returns 

Notes 




none 

none 

Main 


loop 


/ 


/ 


void main(void) 

{ 

/* Local variables */ 
tU08 i; 

MCUInitialisation{); 
LIN_Init 0 ; 


// loop control 

// Initialisation of MCU register 
// LIN Drivers Initialisation service 


LIN drivers TOC attached to output ports 
Disabled on production software 
***************************************y 

/* Disable timer channels from ports */ 

AZ60_TIMER.tasc0.byte = AZ60_TIMER.tasc0.byte & 0xF3; 
AZ60_TIMER.tascl.byte = AZ60_TIMER.tascl.byte & 0xF3; 

/* Enable MC33399 device */ //LIN I/F 

AZ60_PORT.pte.bit.pte3 = 1; 

AZ60_PORT.ddre.bit.ddre3 = 1; 


for (i=0; i<0xff; ++i) // Wait for LIN to switch ON 

/* Enable Global Interrupts */ 
asm 

( 

cli 

} 


/* Transmit Alive Message */ 

MsgWriteBuf[0] = ALIVE_COMMAND; 

MsgWriteBuf[1] = ALIVE_BYTE; 

LIN_PutMsg(SlaveMsg[0].WriteMsg, MsgWriteBuf); // Copy transmit data to LIN buffers 
LIN_RequestMsg(SlaveMsg[0].WriteMsg); // Transmit LIN message 

if ((AZ60_PORT.ptd.byte & OxFO) != 0x00) // Standalone mode or CAN mode 

i 

SystemFlags.bit.canmode=l; // CAN mode 

} 

ScheduleTablelnit (); // Initialise schedule table 
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SystemFlags.bit.loopcontrol=l; 


// Initialise loop control 


/* Main Loop */ 
while (1) 

{ 

/* Wait for timer interrupt or CAN receive message */ 

while ( (SystemFlags .bit. loopcontrol==l) && (SystemFlags .bit .msgrxci==0) ) 


if ((SystemFlags.bit.loopcontrol==0) && (SystemFlags.bit.msgrxd==0)) 

{ 

// Timer interrupt 

ScheduleMsg(); // Schedule another message 


SystemFlags.bit.loopcontrol = 1; // Set up for next loop iteration 

} 

else // CAN message received 

{ 

CanMsgIndex = (AZ60_MSCAN08.rxbuf.dsr[0] & OxOF); 

MsgHandlerTable[CanMsgIndex](); // Jump to message handler table 

SystemFlags.bit.msgrxd = 0; // Set up for next CAN message 


} // end of while (1) 

} // end of main 


!******************** 
Function Name 
Engineer 
Date 


ScheduleTablelnit 


R29414 

09/02/2000 


Parameters : none 

Returns : none 

Notes : Initialise the schedule table. It identifies the slave 

on the LIN bus 

******************************************************************************y 
void ScheduleTablelnit (void) 

{ 

/* Local variables */ 

tO08 i; // Index counter 

tO08 msgTempBuffer[] = {0x00, 0x00}; // Initialise temp buffer 


/* LIN Schedule table Initialisation */ 
for (i=0 ; i<12 ; i++) 


{ 


/* Clear all elements in Slave 
CurrentSlaveStatus [i].ByteO = 
CurrentSlaveStatus [i].Bytel = 


table array*/ 
NO_NODE; // 

NO_NODE; 


NO_NODE 


0x00 


/* Check nodes on Bus */ // Nodes 1 to 12 

for (i=l ; i<13 ; i++) 

{ 

while (LIN_RequestMsg(SlaveMsg[i].ReadMsg) != LIN_OK) // Transmit LIN header 


TimeoutCount = 0x00; 

// 

Initialise 

Timeout 

count 

SystemFlags.bit.Iinmsgtimeout=0; 

// 

Initialise 

timeout 

flag 
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SystemFlags.bit.starttimeout=l; 

while (LIN_MsgStatus(SlaveMsg[i].ReadMsg) 

SystemFlags.bit.starttimeout=0; 


// Start time out 

!=LIN_OK s& SystemFlags.bit.Iinmsgtimeout==0) 

// Wait for new data or timeout 

// Stop timeout. Disables timeout in TIMBOVF_ISR 


if (SystemFlags.bit.Iinmsgtimeout==0) // No Timeout 

{ 

// Valid message received 

LIN_GetMsg (SlaveMsg[i].ReadMsg, msgTempBuffer); // Transfer Node status to Temp buffer */ 

/* Update Current slave status */ 

CurrentSlaveStatus[i-1].ByteO = msgTempBuffer[0]; // 1=< i <13 

CurrentSlaveStatus[i-1].Bytel = msgTempBuffer[1]; 

} 

/* Transmit initial status via CAN if not in standalone mode */ 
if (SystemFlags.bit.canmode==l) // Standalone mode canmode= 0 

{ 

(tU16) i; // i is the CANId 

TxCANMsg(msgTempBuffer, i) ; // Transmit CAN message */ 

} 


} // end of for 

} // End of scheduleTablelnit function 

Task Name : ScheduleMsg 

Engineer : R29414 

Date : 

Parameters : none 

Returns : none 

Notes : Determine mode of demo and calls handler 

******************************************************************************^ 

void ScheduleMsg(void) 

{ 


/* Transmit Alive Message */ 

MsgWriteBuf[0] = ALIVE_COMMAND; 

MsgWriteBuf[1] = ALIVE_BYTE; 

LTN_PutMsg(SlaveMsg[0].WriteMsg, MsgWriteBuf); 


LTN_RequestMsg(SlaveMsg[0].WriteMsg); 
while (LIN_MsgStatus(SlaveMsg[0].WriteMsg) 


if (SystemFlags.bit.canmode==0) 

{ 

DemoMode = AZ60_PORT.ptd.byte & 0x03; 

} 

switch (DemoMode) 

{ 

case DEFAULT: 

DefaultMsgHandler() ; 
break; 

case BROADCAST: 


// Transmit message 

!=LTN_OK) // Wait for message request complete 

// Check mode 
// Stand alone mode 

// Call NodeMsgHandler 
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BroadcastMsgHandler(); // Call BroadcastMsgHandler 

break; 

case IDENT; 

IdentMsgHandler(); // Call IdentMsgHandler 

break; 

case SLEEPMODE; // Call SleepHandler 

SleepHandler(); 
break; 

default; 

break; 

} // End of switch 

} // End scheduleMsg 


Task Name : DefaultMsgHandler 

Engineer : R29414 

Date : 26/07/2000 

Parameters : none 

Returns : none 

Notes : 

*******************************************************************************y 

void DefaultMsgHandler(void) 

{ 

if ((Scheduleindex <1) || (Scheduieindex >= 13)) // Check index is within range 1 to 12 

{ 

// Out of range 

Scheduleindex =1; // make index = 1 

} 

/* Within range */ 

if ((Scheduleindex == 12) || (Scheduleindex == 6)) // Valid Scheduleindex 

( 

/* Node 12 or 6 */ 

LINTransmit(Scheduleindex, ALL_LEDS_ON, MsgReadBufI); // Transmit specified message header frame 

} 

eise 

( 

AltScheduleIndex = 12 - Scheduleindex; // Calculate alternate index 

LINTransmit(Scheduleindex, RED_LEDS_ON, MsgReadBufI); // Transmit specified message header frame 

LINTransmit(AltScheduleIndex, GREEN_LEDS_ON, MsgReadBuf2); // Transmit specified message header 

frame */ 

} 


/* Compare status data with previous data */ 

if ((CurrentSlaveStatus[Scheduieindex - l].ByteO != MsgReadBuf1[0] ) I I 
(CurrentSlaveStatus[Scheduleindex - l].Bytel != MsgReadBuf1[1])) 

[ 

if (SystemFlags.bit.canmode==I) // Do not transmit if standalone mode 

{ // Standalone =0 

(tU16) Scheduleindex; // Scheduleindex is the CANId 

TxCANMsg(MsgReadBufI,Scheduleindex) ; // Transmit CAN message 

} 


CurrentSlaveStatus[Scheduleindex - IJ.ByteO = MsgReadBufI[0]; // Update status data 
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CurrentSlaveStatus[Scheduleindex - l].Bytel = MsgReadBuf1[1]; 

} 


} // End DefaultMsgHandler 

Task Name : LINTransmit 

Engineer : R29414 

Date : 26/07/2000 


Parameters : index, ledcommand, 

Returns : none 

Notes : 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

void LINTransmit(tU08 index, tU08 ledcommand, 

{ 

TimeoutCount = 0x00; 

SystemFlags.bit.linmsgtimeout=0; 

LIN_RequestMsg(SlaveMsg[index].ReadMsg); 

SystemFlags.bit.starttimeout=l; 


, &msgbuffer 

tU08 *msgbuffer) 

// Initialise Timeout count 
// Initialise Timeout 

// Transmit specified message header frame 
// Start Timeout 


/* Wait for new data or timeout */ 

while (LIN_MsgStatus(SlaveMsg[index].ReadMsg) !=LIN_OK && SystemFlags.bit.Iinmsgtimeout==0) 


SystemFlags.bit.starttimeout=0; // Stop timeout 

if (SystemFlags.bit.Iinmsgtimeout==0) // Check if valid LIN message received 

{ 

LIN_GetMsg(SlaveMsg[index].ReadMsg, msgbuffer); // Store status information 

MsgWriteBuf[0] = SLAVE_LEDS_COMMAND; 

MsgWriteBuf[1] = ledcommand; //Set up write buffer to transmit command to node 

/* Transmit default message to node x */ 

LIN_PutMsg(SlaveMsg[index].WriteMsg, MsgWriteBuf); 

LIN_RequestMsg(SlaveMsg[index].WriteMsg); 

while (LIN_MsgStatus(SlaveMsg[index].WriteMsg) !=LIN_OK) // Wait for transmission to complete 


} 

else 

{ 

msgbuffer[0] = NO_NODE; 
msgbuffer[1] = NO_NODE; 


// Timeout 

// Update temporary buffer indicating that no node */ 


} /* End LINTransmit */ 

Task Name : BroadcastMsgHandler 

Engineer : R29414 

Date : 

Parameters : none 

Returns : none 

Notes : 

*******************************************************************************y 
void 

BroadcastMsgHandler(void) 
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if (Broadcastindex < 0 || Broadcastindex >7) // Dont let Index outwith range 

{ 

Broadcastindex = 0; 

} 


MsgWriteBuf[0] = BROADCAST_COMMAND; 

MsgWriteBuf[1] = BroadcastTable[Broadcastindex]; 

LIN_PutMsg(SlaveMsg[0].WriteMsg, MsgWriteBuf); 

LIN_RequestMsg(SlaveMsg[0].WriteMsg); 

while (LIN_MsgStatus(SlaveMsg[0].WriteMsg) !=LIN_OK) // Wait for message complete 


if (Broadcastindex == 0) 

{ 

SystemFlags.bit.updowncontrol = 0; 


if (Broadcastindex == 7) 

{ 

SystemFlags.bit.updowncontrol = 1; 

} 


//Up Counter 


// Down Counter 


} // End of BroadcastMsgHandler 

^****************************************************************************** 

Task Name : IdentMsgHandler 

Engineer : R29414 

Date : 

Parameters : none 

Returns : none 

Notes : 

*******************************************************************************^ 
void 

IdentMsgHandler(void) 

{ 

MsgWriteBuf[0] = IDENT_COMMAND; 

MsgWriteBuf[1] = AZ60_PORT.ptd.byte; // Hex switch input 

LIN_PutMsg(SlaveMsg[0] .WriteMsg, MsgWriteBuf) ; 

LIN_RequestMsg(SlaveMsg[0].WriteMsg); 

while (LIN_MsgStatus(SlaveMsg[0].WriteMsg) !=LIN_OK); // Wait for message complete 
} // End of BroadcastMsgHandler 


/****************************************************************************** 

Task Name : MCUInitialisation 

Engineer : R29414 

Date : 

Parameters : none 

Returns : none 

Notes : Initialise the mcu hardware 

*******************************************************************************y 

void MCUInitialisation(void) 

{ 

/* Device configuration */ 

AZ60_KBD.configl.bit.copd = 1; 

AZ60_SIM.config2.byte = 1; 

/* Ports Initialisation */ 

AZ60_PORT.ddrd.byte = 0x00; // PortD i/p for HEX switches 


// Disable Watchdog 

// AZ Mode and CAN enabled 


AN2103 


For More Information On This Product, 
Go to: www.freescale.com 







Freescale Semiconductor, Inc 


Freescale Semiconductor, Inc. 

Code Listings 
Master Code - MasterOS.C 


AZ60_PORT.ptb.byte = OxFF; 
AZ60_PORT.ddrb.byte = OxFF; 

AZ60_PORT.ptc.bit.ptcO = 0; 

AZ60_PORT.ddrc.bit.ddrcO = 1; 

/* CAN I/F Configuration */ 

SetMC33388Mode(NORMAL); 

AZ60_PORT.ddrf.byte = PTF4|PTF3; 

SystemFiags.byte = 0; 

InitiaiiseMSCAN08(); 

StatusMsg.id.w[0] = 0x0000; 

StatusMsg.dir = 0; 

StatusMsg.tbpr = 0; 

/* Initiaiise TIME Overflow */ 
AZ60_TIMER.tbsc.byte = 0x30; 

AZ60_TIMER.tbmod.word = 0x3E8; 
AZ60_TIMER.tbsc.byte = 0x40; 

} //End of MCU Initialisation 

Function Name : TxCANMsg 

Engineer : R29414 

Date : 22/02/00 

Parameters : *MsgBuffer, CANId 

Returns : None 

Notes : 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

void TxCANMsg (tU08 *MsgBuffer, tD16 CANId) 

{ 

tO08 i; 

StatusMsg.id.w[0] = ((CANId «5) & OxFFEO) ; 

StatusMsg.dir = sizeof(MsgBuffer); 

for (i=0 ; i < StatusMsg.dir ; i++ ) 

{ 

StatusMsg.dsr[i] = MsgBuffer[i]; 

} 

TxCANBuffer(SStatusMsg,MSCAN_TX0) ; 


// Port B o/p for LEDs 


// put MC33388 into normal mode 
// PTF3=EN and PTF4=STB pins on MC33388 

// reset all system flags 

// MSCAN Initialisation 

// standard 11-bit ID = 1 
// 0 data bytes 

// set CAN status message ID, DLR and priority 


// Reset TIME 

// 1ms overflow when IMeg Bus and pre-scale=0 
// Enable TIME OVR Interrupt & Start timer 


// Calculate id 

// Calculate number of data bytes in buffer 
// Transfer data bytes to CAN message buffer 


} 

/****************************************************************************** 
Function Name : TxCANBuffer 

Engineer : R38917 

Date : 11/02/00 

Parameters : *Buffer, TxBufferlD 

Returns : None 

Notes : 

******************************************************************************y 

void TxCANBuffer(tTXBOF *Buffer, tO08 TxBufferlD) 

{ 

tO08 i; 
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while(!(AZ60_MSCAN08.ctfig.byte & TxBufferlD)) 


/*** 

Timeout Period And Abort Stuff ? 

***/ 

AZ60_MSCAN08.txbuf[{TxBufferlD >> l)].id.l = Buffer -> id.l; 

for(i=0 ; i < Buffer -> dir ; i++) 

AZ60_MSCAN08.txbuf[(TxBufferlD >> l)].dsr[i] = Buffer -> dsr[i]; 

AZ60_MSCAN08.txbuf[(TxBufferlD >> l)].dlr = Buffer -> dir; 

AZ60_MSCAN08.txbuf[(TxBufferlD >> l)].tbpr = Buffer -> tbpr; 

AZ60_MSCAN08.ctfig.byte = TxBufferlD; 

} 

/****************************************************************************** 
Function Name : SetMC33388Mode 

Engineer : R38917 

Date : 11/02/00 

Parameters : Mode 

Returns : None 

Notes : 

■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^ 

void SetMC33388Mode(enum tMC33388 Mode) 

{ 

switch(Mode) 

{ 

case SLEEP; 

AZ60_PORT.ptf.byte = 0; //STB=EN=0 

break; 

case SLEEP_RQ; 

AZ60_PORT.ptf.byte = PTF3; //STB=0,EN=1 

break; 

case RX_ONLY; 

AZ60_PORT.ptf.byte = PTF4; //STB=1,EN=0 

break; 

case NORMAL; 

AZ60_PORT.ptf.byte = PTF4|PTF3; //STB=EN=1 

break; 

default; 

} 

} 


^-k-kk-kkkkkkkkkkkkkkkkk-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Function Name : CommonMsgHandler 

Engineer : R38917 

Date : 20/07/00 

Parameters : None 

Returns : None 

Notes : This handler is common to the 12 messages as only the index is different. 

******************************************************************************y 

void CommonMsgHandler(void) // Common handler replaces Nodel - Nodel2 handlers 
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tU08 msgSent[] = {CLOCK_LEDS_COMMAND, ALL_LEDS_OFF} ; 


// Local Declaration 


LIN_PutMsg (SlaveMsg[CanMsgIndex].WriteMsg, msgSent); 
LIN_RequestMsg(SlaveMsg[CanMsgIndex].WriteMsg); 


// Transfer data to LIN Msg buffer 
// Request a message 


while (LIN_MsgStatus(SlaveMsg[CanMsgIndex].WriteMsg) 

} 


LIN_OK)// Wait a while 


^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Function Name : SleepHandler 

Engineer : R38917 

Date : 11/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 

void SleepHandler(void) 

{ 

/* Send out LIN Sleep command */ 

MsgWriteBuf[0] = SLEEP_COMMAND; 

MsgWriteBuf[1] = 0x00; 

LIN_PutMsg(SlaveMsg[0].WriteMsg, MsgWriteBuf); 

LIN_RequestMsg(SlaveMsg[0] .WriteMsg) ; 


while (LIN_MsgStatus(SlaveMsg[0].WriteMsg) !=LIN_OK) // Wait for message complete 


AZ60_PORT.pte.bit.pte3 = 0; 
SetMC33388Mode(SLEEP_RQ); 
SetMC33388Mode(SLEEP) ; 
while(1) 

} 


// Disable UPL 


//placing MC33388 into SLEEP mode switches off the Vreg 


^************************************* 
Function Name : ModeSelect 

Engineer : R38917 

Date : 10/02/00 


Parameters : None 

Returns : None 

Notes : 

************************************** 


void ModeSelect(void) 

{ 

switch(AZ60_MSCAN08.rxbuf.dsr[1]) 

{ 

case DEFAULT: 

DemoMode = DEFAULT; 
break; 

case BROADCAST: 


// Demo mode in bytel 


// Put demo in default mode 
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DemoMode = BROADCAST; 
Broadcastindex = 0; 
break; 

case IDENT: 

DemoMode = IDENT; 
break; 

default: 



// Put demo in broadcast mode 


// Put demo in IDENT mode 


^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Function Name : DefaultHandler 

Engineer : R38917 

Date : 11/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 

void DefaultHandler(void) 

{ 

} 


y******************************************** 
Function Name : InitialiseMSCANO8 

Engineer : R38917 

Date : 10/02/00 

Parameters : None 

Returns : None 

Notes : 

********************************************* 

void InitialiseMSCANOS(void) 

{ 

AZ60_MSCAN08.cmcrO.bit.sftres = 1; 

AZ60_MSCAN08.cbtrO.byte = CBT0_125K; 
AZ60_MSCAN08.cbtrl.byte = CBT1_125K; 

AZ60_MSCAN08.cid.mr.l = OxFFFFFFFF; 

AZ60_MSCAN08.cmcrO.bit.sftres = 0; 

AZ60_MSCAN08.crier.bit.rxfie = 1; 

while(!AZ60_MSCAN08.cmcrO.bit.synch) 

} 


//put CAN module in soft reset 


//accept all messages 

//release CAN module from soft reset 

//enable CAN receive interrupts 

//wait for CAN bus to synchronize 


y****************************************************************************** 
Task Name : TimerB Overflow 

Engineer : R29414 

Date : 

Parameters : none 

Returns : none 

Notes : Overflow period set at 1ms. 

******************************************************************************y 
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/* Hiware compiler */ 
#pragma TRAP_PROC 


void TIMBOVF_ISR (void) 

{ 

if (LoopControlTime<LOOP_CONTROL_PERIOD) 

i 

LoopControlTime++; 

} 

else 

i 

LoopControlTime=OxO 0; 

SystemFlags.bit.loopcontrol =0; 
Schedulelndex++; 

if (Scheduleindex >=13) 

{ 

Scheduleindex = 0x01; 

} 


// Loop control timer timeout 
// LoopControlPeriod set in header file 


// Reset LoopControlTime 
// Clear system flag 
// Increment Schedule Table Index 


// Reset Schedule Index 


if (DemoMode == BROADCAST) 

{ 

if (SystemFlags.bit.updowncontrol == 0) 

i 

BroadcastIndex++; 

} 

else 

i 

BroadcastIndex—; 



if (SystemFlags.bit.starttimeout == 1) 

( 

if (TimeoutCount<TIMEOUT_PERIOD) // Timeoutperiod set in header file 

{ 

TimeoutCount++; 


else 

{ 


SystemFlags.bit.linmsgtimeout =1; 


// Set Timeout flag 


/* Clear Interrupt flag */ 

AZ60_TIMER.tbsc.byte &= ~TOF; // Read TBSCO and write 0 to CHOF 


} // End of ISR 

/****************************************************************************** 
Function Name : CANRxISR 

Engineer : R38917 

Date : 10/02/00 

Parameters : None 
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Returns : None 

Notes : CAN message received interrupt service routine 

******************************************************************************^ 


#pragma TRAP_PROC 

void CANRx_ISR(void) 

{ 

SystemFlags.bit.msgrxd = 1; 

AZ60_MSCAN08.erfIg.bit.rxf = 1; //clear interrupt flag 

} // End ISR 


5.2 Master Code - MASTER08.H 


!******************** 

File Name 

Engineer 

Location 

Date Created 

Current Revision 

Notes 


MASTER08.C 
R29414 

EKB 

07/02/2000 


Copyright 


(c) 


$Revision;1.0 $ 

LIN driver header file 


******************************************************************************* 
Freescal e reserves the right to make changes without further notice to any 
Product herein to improve reliability, function or design. FreeSCal 6 does not 
assume any liability arising out of the application or use of any product, 
circuit, or software described herein; neither does it convey any license 
under its patent rights nor the rights of others. FreeSCal 6 products are not 
designed, intended, or authorized for use as components in systems intended for 
surgical implant into the body, or other applications intended to support life, 
or for any other application in which the failure of the FreeSCal 6 product 
could create a situation where personal injury or death may occur. Should 
Buyer purchase or use FreeSCal 6 products for any such unintended or 
unauthorized application. Buyer shall idemnify and hold Freescal 6 and its 
officers, employees, subsidiaries, affiliates, and distributors harmless 
against all claims costs, damages, and expenses, and reasonable attorney fees 
arising out of, directly or indirectly, any claim of personal injury or death 
associated with such unintended or unauthorized use, even if such claim alleges 
that Freescal e was negligent regarding the design or manufacture of the part. 

Freescal e and the Freescal e logo* are registered trademarks of Freescale, Inc, 
************************************************************************************^ 
#ifndef MASTER08CODEREVIEW_H 
#define MASTER08CODEREVIEW_H 


/************************* System Include Files 


/************************* Project Include Files *****************************/ 
#include "c:\header_files\hc08\common.h" // common data structure 

#include "c:\header_files\hc08\mscan08.h" // common data structure 


!************************* User #Defines *************************************/ 
/* Timmer period Control */ 

#define LOOP_CONTROL_PERIOD 150 
#define TIMEOUT_PERIOD 10 
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/************************* typedefs ******************************************/ 

typedef struct SlaveNodeMsgStruct 

tU08 WriteMsg; 

tU08 ReadMsg; 

} SlaveNodeMsgType; 


typedef struct SlaveMsgBufferStruct 

tU08 ByteO; 

tU08 Bytel; 

} SlaveMsgBufferXype; 


■ 

o 

c 


typedef union 

tU08 byte; 

struct 

{ 

tU08 msgrxd;!; 
tU08 loopcontrol ;1; 
tU08 updowncontrol ;1; 
tU08 canmode ;1; 
tU08 linmsgtimeout ;1; 
tU08 starttimeout ;1; 
tU08 ;2; 

}bit; 

}tFLAG; 


//target connection established 
//Loop controi flag 

//Broadcast message up down flag 0=Up, l=Down 


//Flag indicates mode. 
//LIN timeout. Timeout 
//LIN timeout. Timeout 
// not used 


Standaione = I CAN = 0 
= I, OK = 0 
= I, OK = 0 


typedef enum 

i 

DEFAULT, 
BROADCAST, 
TDENT, 
SLEEPMODE 
} DemoModeType_t; 


enumtMC33388 

{ 

SLEEP, 

SLEEP_RQ, 

RX_ONLY, 

NORMAL 

}; 


/************************* #Defines ******************************************/ 
/* Timmer period Control */ 


#define NODE_CONNECTED 0x80 

#define NO_NODE 0x00 

#define CBT0_125K OxCO 

#define CBT1_125K 0xD8 

#define MSCAN_TX0 0x01 


//based on a 4MHz xtal, 3 sampling points, SJW = 4 
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■ 

O 

c 


#define 

MSCAN_TX1 

0x02 

#define 

MSCAN_TX2 

0x04 

#define 

LED0_ON 

0x01 

#define 

LED1_0N 

0x02 

#define 

LED2_ON 

0x04 

#define 

LED3_ON 

0x08 

#define 

LED4_ON 

0x10 

#define 

LED5_ON 

0x20 

#define 

LED6_ON 

0x40 

#define 

LED7_ON 

0x80 

#define 

ALL_LEDS_ON 

0x00 

#define 

ALL_LEDS_OFF 

OxFF 

#define 

GREEN_LEDS_ON 

OxOF 

#define 

RED_LEDS_ON 

OxFO 


/* command bytes */ 

#define SLAVE_LEDS_COMMAND 0x01 
#define BROADCAST_COMMAND 0x02 
#define CLOCK_LEDS_COMMAND 0x03 
#define IDENT_COMMAND 0x04 
#define SLEEP_COMMAND 0x08 
#define ALIVE_COMMAND OxOF 
#define ALIVE_BYTE OxAD 


/************************* Macros 


/************************* Prototypes ****************************************/ 

void MCUInitialisation (void); 

void ScheduleTablelnit (void); 

void ScheduleMsg (void); 

void DefaultMsgHandler (void); 

void BroadcastMsgHandier (void); 

void IdentMsgHandler(void) ; 

void TxCANMsg (tU08 * , tD16); 

void CommonMsgHandler(void) ; 

void TxCANBuffer(tTXBOF * ,tO08); 

void SetMC33388Mode(enum tMC33388); 

void SleepHandler(void); 

void StatusRequestHandier(void) ; 

void ModeSelect(void) ; 

void DefaultHandler(void) ; 

void InitialiseMSCAN08(void); 

void LINTransmit(tU08, tD08, tD08 *) ; 


#endif/* End of Header fiie ifndef*/ 


5.3 Slave Code - SLAVE08.C 


File Name : SLAVE08.C 


Copyright (c) 


Engineer 

Project 


TTZ740 

SAE Demo Project 


Location 


EKB 
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Date Created 

Current Revision 

Functions 

Tasks 


27 January 2000 
$Revision:1.0 


Freescal e reserves the right to make changes without further notice to any 
Product herein to improve reliability, function or design. FreeSCal 6 does not 
assume any liability arising out of the application or use of any product, 
circuit, or software described herein; neither does it convey any license 
under its patent rights nor the rights of others. FreeSCal 6 products are not 
designed, intended, or authorized for use as components in systems intended for 
surgical implant into the body, or other applications intended to support life, 
or for any other application in which the failure of the FreeSCal 6 product 
could create a situation where personal injury or death may occur. Should 
Buyer purchase or use Freescal 6 products for any such unintended or 
unauthorized application. Buyer shall idemnify and hold Freescal 6 and its 
officers, employees, subsidiaries, affiliates, and distributors harmless 
against all claims costs, damages, and expenses, and reasonable attorney fees 
arising out of, directly or indirectly, any claim of personal injury ordeath 
associated with such unintended or unauthorized use, even if such claim alleges 
that Freescal e was negligent regarding the design or manufacture of the part. 

Freescal e and the Freescal e logo* are registered trademarks of Freescale Inc. . 
************************************************************************************^ 




System Include Files ********************* 


#include "SAEdemo.h" 
#include <linapi.h> 
#include <port.h> 
#include <sim.h> 
#include <kbd.h> 
#include <si.h> 
#include <timer.h> 


//demo header file 
//lin driver api 
//port registers definitions 
//system register definitions 
//register definitions 
//register definitions 
//register definitions 


/************************* Declarations ***************************** 


/ 


/ 


/*************************** ^ 

defines ****************************** 

#define 

AZ60 (*(tPORT 

*) 

(0x0000) ) 

#define 

SIM (*(tSIM 

*) 

(OxFEOO)) 

#define 

KBD (*(tKBD 

*) 

(OxOOlA)) 

#define 

SI (*(tSI 

*) 

(0x0010)) 

#define 

TIMER (*(tTIMER 

*) 

(0x0020)) 

/************************* typedefs 

********************************* 

typedef 

f 

union 



t 

tO08 

byte; 



Struct 




1 

tU08 enableTimeout 

: 1 

; //enable defautl mode timeout 


tU08 enableExternal 

: 1 

; //enable external timeout 


tU08 disableWaketime 

: 1 

; 


tU08 

:5 

; //not used 


}bit; 




}tFLAG; 


/ 


/ 
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enum tMC33388 

{ 

SLEEP, 

SLEEP_RQ, 

RX_ONLY, 

NORMAL 

}; 


/************************* Global Variables 


tFLAG 

SystemFlags; 

tD08 

REDTIMticks = 0; 

tO08 

GREENTIMticks = 0; 

tO08 

EXTERNTIMticks = 0 

tO08 

TIMticks = 0; 

tD08 

MsgSent [2] ; 

tD08 

MsgRcvd[2]; 

t016 

WakeupTimeout = 0; 




^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Function Name : SetMC33388Mode 

Engineer : r38917 

Date : 11/02/00 

Parameters : Mode 

Returns : None 

Notes : 

******************************************************************************y 

void SetMC33388Mode(enum tMC33388 Mode) 

{ 

switch(Mode) 

{ 

case SLEEP; 

AZ60.ptf.byte = 0; //STB=EN=0 

break; 

case SLEEP_RQ; 

AZ60.ptf.byte = PTF3; //STB=0,EN=1 

break; 

case RX_ONLY; 

AZ60.ptf.byte = PTF4; //STB=1,EN=0 

break; 

case NORMAL; 

AZ60.ptf.byte = PTF4|PTF3; //STB=EN=1 

break; 

default; 

} 

} 


/****************************************************************************** 
Function Name : Rotating LEDs message 

Engineer : TTZ740 
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Date : 10/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************y 

void RotatingHandler(void) 

{ 

if {{MsgRcvd[l] & RED_LED_MASK) != RED_LED_MASK) 

REDTIMticks = 0; //reset red timeout period 

if {{MsgRcvd[l] & GREEN_LED_MASK) != GREEN_LED_MASK) 

GREENTIMticks = 0; //reset green timeout period 

SystemFlags.bit.enableTimeout = 1; 

AZ60.ptb.byte = MsgRcvd[l]; //send data to portb to switch on LEDs 

} 


^****************************************************************************** 
Function Name : Broadcast message 

Engineer : TTZ740 

Date : 10/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 
void BroadcastHandler(void) 

SystemFlags.bit.enabieTimeout = 0; 

AZ60.ptb.byte = -MsgRcvdtl]; //output data byte to port 

} 


/****************************************************************************** 
Function Name : External LED message 

Engineer : TTZ740 

Date : 10/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 

void ExternalHandler(void) 

{ 

EXTERNTIMticks = 0; //reset external timeout period 

SystemFlags.bit.enableExternal = 1; 

AZ60.pte.bit.pte4 = 1; //switch on external LED 

} 


y****************************************************************************** 
Function Name : MsgHandler4 

Engineer : TTZ740 

Date : 10/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 
void IdentifyHandler(void) 
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{ 

SystemFlags.bit.enableTimeout = 0; 

AZ60.ptb.byte = ~nodeID; //display node ID on LEDs 

} 


Function Name : SleepHandler 

Engineer : r38917 

Date : 11/02/00 


Parameters : None 

Returns : None 

Notes : 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

void SleepHandler(void) 

i 

Azeo.ddrf.byte = DDRF3IDDRF4; 
AZ60.pte.bit.pte3 = 0; 

SetMC33388Mode(NORMAL); 

SetMC33388Mode(SLEEP_RQ) ; 

SetMC33388Mode(SLEEP) ; 

while(1) 

} 


//enable PTF pins as output 
//disable UPL interface 

//MC33388 can't be put to sleep from Vbat 
//standby mode 


//placing MC33388 into SLEEP mode switches off the Vreg 


^■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Function Name : DefaultHandler 

Engineer : r38917 

Date : 11/02/00 

Parameters : None 

Returns : None 

Notes : 

******************************************************************************^ 

void DefaultHandler(void) 
i 
} 

^****************************************************************************** 

Message handler vector table 

******************************************************************************y 

void (* const MsgHandlerTable[]) {) = 

{ 

DefaultHandler, 

RotatingHandler, 

BroadcastHandler, 

ExternalHandler, 

IdentifyHandler, 

DefaultHandler, 

DefaultHandler, 

DefaultHandler, 

SleepHandler, 

DefaultHandler, 

DefaultHandler, 

DefaultHandler, 

DefaultHandler, 

DefaultHandler, 
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DefaultHandler, 
DefaultHandler 
}; 


^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Task Name : LINInitialise 

Engineer : TTZ740 

Date : 


Parameters : none 

Returns : none 

Notes : LIN driver timer setup causes output compare pins to toggle 

: which creates a conflict with the hardware design 

******************************************************************************y 


void LINInitialise(void) 

{ 

LIN_Init(); //initialise LIN driver 

TIMER.tascO.byte = TIMER.tascO.byte & 0xF3; 

TIMER.tasci.byte = TIMER.tascl.byte & 0xF3; 

} 


y****************************************************************************** 

Task Name : LINWakeup 

Engineer : TTZ740 

Date : 

Parameters: none 

Returns : none 

Notes : Initial hardware design used the UPL interface, which is 

: not compatible with the LIN protocol for bus wakeup, hence 

: a custom wakeup routine is required for the UPL interface 

******************************************************************************y 

void LINWakeup(void) 

( 

SI. sci.sccl.bit.ensci = 0; 

SI. sci.scbr.bit.scr = 1; 

SI. sci.scbr.bit.scp = 1; 

SI.sci.sccl.bit.ensci = 1; 

SI. sci.scc2.bit.te = 1; 


while (SI.sci.SCSI.bit.scte == 0) 


Sl.sci.scdr = OxAA; // send wake up 

while (SI.sci.SCSI.bit.tc == 0) 


LINInitialise0; //initialise LIN driver 

} 


// disable SCI 
// 10400 baud 
// 10400 baud 
// enable SCI 
// enable transmit 


y****************************************************************************** 
Task Name : initialise 

Engineer : TTZ740 

Date : 


Parameters : none 

Returns : none 
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Notes : 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

void initialise (void) 

{ 

tU08 i = 0; 

SIM.config2.byte = 0x11; 

KBD.configl.byte = 0x71; 

AZ60.ptb.byte = ALL_LEDS_OFF; 
AZ60.ddrb.byte = OxFF; 

SystemFlags.byte = 0; 

LINInitialise(); 

TIMER.tsc.byte = 0x54; 

TIMER.tmod.word = OxOOSE; 

AZ60.pte.byte = PTE3; 
AZ60.ddre.byte = DDRE3|DDRE4; 

for (i = 0; i < OxFF; ++i) 

} 


//disable CAN module, enable AZ mode 
//disable COP 

//port b LEDs switch off 
//set port b to output 

//reset the system flags 


//enable ovf interrupt, rst counter and /16 prescaler 
//ImS overflow based on 4MHz xtal 

//enable UPL device, switch off external LED 


//delay for UPL to switch on 


Task Name : main 

Engineer : TTZ740 

Date : 


Parameters : none 
Returns : none 
Notes : 

******************************************************************************y 


void main( void ) 

initialise() ; 

asm cli; 

while ( 1 ) 

{ 

MsgSent[0] = nodelD; 

MsgSent[l] = AZ60.ptd.byte; 

LIN_PutMsg(MESSAGESEND, MsgSent); 


//initialisation routine 
//enable global interrupts 


//data bytel to be sent is node ID 
//Data bytel to be sent is switch status 
//send data to data buffer 


if (LIN_MsgStatus(MESSAGESEND) != LIN_MSG_NOCHANGE) 

i 

WakeupTimeout = 0; //reset wakeup timeout 

} 


if (LIN_MsgStatus(MESSAGERECEIVE) == LIN_OK)//if new message 

i 

LIN_GetMsg(MESSAGERECEIVE, MsgRcvd); //read the message 

MsgHandlerTable[(MsgRcvd[0] & OxOF)]();//call subroutine for appropriate command 
WakeupTimeout = 0; //reset wakeup timeout 

} 

if (LIN_MsgStatus(BROADCASTRECEIVE) == LIN_OK)//if new broadcast message 

i 
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LIN_GetMsg(BROADCASTRECEIVE, MsgRcvd); //read the message 

MsgHandlerTable[(MsgRcvd[0] & OxOF)] (); //call subroutine for appropriate command 
WakeupTimeout = 0; //reset wakeup timeout 

} 



Task Name : PIT_ISR 

Engineer : TTZ740 

Date : 

Parameters : none 

Returns : none 

Notes : 

******************************************************************************y 


#pragma TRAP_PROC 

void PIT_ISR(void) 

{ 

if(SystemFlags.bit.enableTimeout) 

{ 

if(REDTIMticks < REDTIMPeriod) //check if timeout period for red LEDs has expired 

i 

REDTIMticks++; //increment ticks 

} 

else 

i 

AZ60.ptb.byte |= RED_LED_MASK; //switch off red LEDs 

} 


if(GREENTIMticks < GREENTIMPeriod) 
i 

GREENTIMticks++; 


else 

i 

AZ60.ptb.byte |= GREEN_LED_MASK; 
} 


//check if timeout period for green LEDs has expired 
//increment ticks 

//switch off green LEDs 


if(AZ60.ptb.byte == ALL_LEDS_OFF) 

SystemFlags.bit.enableTimeout = 0; 

} 


if(SystemFlags.bit.enableExternal) 

{ 

if(EXTERNTIMticks < EXTERNTIMPeriod) //check if timeout period for external LEDs has expired 

i 

EXTERNTIMticks+l; //increment ticks 

} 

else 

i 

AZ60.pte.bit.pte4 = 0; //switch off external LED 

} 

if(!AZ60.pte.bit.pte4) 

SystemFlags.bit.enableExternal = 0; 

} 

if (!SystemFlags.bit.disableWaketime) 

i 
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if(WakeupTimeout < TXWAKEUPMSG) 
WakeupTimeout++; 

else 


static tDOSretry = 0; 
if (retry < 3) 

{ 

WakeupTimeout = 0; //reset wakeup timeout 
LINWakeupO; //attempt to wake up network 

retry+f; 


else 

SystemFlags.bit.disableWaketime = 1; 

} 


TIMER.tsc.bit.tof = 0; 


//clear the overflow flag 


5.4 Slave Code - SLAVE08.H 


!******************** 

File Name 

Engineer 

Location 

Date Created 

Current Revision 

Notes 


SLAVE08.C 
TTZ740 

EKB 

07/02/2000 


Copyright (c) 


$Revision;1.0 $ 

LIN driver header file 


******************************************************************************* 
FreeSCal e reserves the right to make changes without further notice to any 
Product herein to improve reliability, function or design. FreeSCal 6 does not 
assume any liability arising out of the application or use of any product, 
circuit, or software described herein; neither does it convey any license 
under its patent rights nor the rights of others. FreeSCal 6 products are not 
designed, intended, or authorized for use as components in systems intended for 
surgical implant into the body, or other applications intended to support life, 
or for any other application in which the failure of the FreeSCal 6 product 
could create a situation where personal injury or death may occur. Should 
Buyer purchase or use Freescal 6 products for any such unintended or 
unauthorized application. Buyer shall idemnify and hold Freescal 6 and its 
officers, employees, subsidiaries, affiliates, and distributors harmless 
against all claims costs, damages, and expenses, and reasonable attorney fees 
arising out of, directly or indirectly, any claim of personal injury ordeath 
associated with such unintended or unauthorized use, even if such claim alleges 
that Freescal e was negligent regarding the design or manufacture of the part. 

Freescal e and the Freescal e logo* are registered trademarks of Freescale Inc, 
************************************************************************************y 
#ifndef SLAVE08_H 
#define SLAVE08_H 

/************************* #Defines ******************************************/ 

/* standard defs that may be defined by compiier / 
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#if !defined(TRUE) 

#define TRUE 0x01 

#define FALSE 0x00 

#endif 

#define ON TRUE 

#define OFF FALSE 

#define YES TRUE 

#define NO FALSE 



#define 

RED_LED_MASK 

OxOF 







#define 

GREEN_LED_iyiASK 

OxFO 







#define 

RED_LEDS_ON 

OxFO 







#define 

GREEN_LEDS_ON 

OxOF 







#define 

ALL_LEDS_OFF 

OxFF 






n 

#define 

ALL_LEDS_ON 

0x00 






O 

#define 

REDTIMPeriod 

150 

//generates 

150mS 

timeout 

(4MHz 

xtal) 

c 

#define 

GREENTIMPeriod 

150 

//generates 

150mS 

timeout 

(4MHz 

xtai) 


#define 

EXTERNTIMPeriod 

150 

//generates 

150mS 

timeout 

(4MHz 

xtal) 


#define 

TXWAKEUPMSG 

200 









#endif /* End of Header file ifndef */ 


6 Schematic 
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